home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / dev / c / LEDA_GUI.lha / README_install < prev    next >
Encoding:
Text File  |  1995-03-27  |  4.9 KB  |  145 lines
  1. Hello LEDA users.
  2.  
  3.     This  is  my second version of the Wx library for the LEDA package.  It
  4. has nearly the same functionality as the X11 version, except for some small
  5. shortcomings. Read README.LEDA if you don't know where to obtain LEDA.
  6.  
  7.     What  you  need  to use this package is:  a current version of LEDA.  I
  8. still  use  Version  3.1.1  since  I  have  some  problems compiling 3.1.2,
  9. apparently  due  to  lack  of  memory.   Versions  prior to 3.1.1 need many
  10. changes  to  compile  on an Amiga, so using them is discouraged.  LEDA is a
  11. big  library,  most  programs  will  require about 9 MB to compile, and the
  12. stack  must  be  set  to 500000, the default 350000 will not suffice in all
  13. cases.
  14.  
  15.  
  16. INSTALLATION:
  17.  
  18.     I'll  keep  this part short.  since you are a programmer, you know what
  19. to  do  here.   The Assigns are just for easy reference here and not needed
  20. after installation. NOTE: you must edit the <...> below.
  21.  
  22. ---------------------------------------------------------------------------
  23. assign LEDA: <whatever>:LEDA-3.1.2
  24. assign HERE: ""
  25. ;
  26. ; save original files
  27. ;
  28. cd LEDA:incl/LEDA
  29. rename basic.h basic.h.orig
  30. cd LEDA:prog
  31. rename Make.pro Make.pro.orig
  32. cd LEDA:src
  33. rename Make.src Make.src.orig
  34. rename Makefile Makefile.orig
  35. ;
  36. ; adding new files (you may check out the archive first)
  37. ;
  38. cd LEDA:
  39. lha x HERE:files.lha
  40. ;
  41. ; now edit ENV_LEDAGUI to suit your needs
  42. ;
  43. cd LEDA:src/amiga
  44. <your_editor> ENV_LEDAGUI
  45. copy ENV_LEDAGUI ENV:LEDAGUI
  46. copy ENV_LEDAGUI ENVARC:LEDAGUI
  47. makedir usr:lib/X11
  48. copy X11_RGB usr:lib/X11/rgb.txt
  49. ---------------------------------------------------------------------------
  50.  
  51.     The  ready-made  "libWx.a"  is compiled with "-m68030 -m68881 -O2".  If
  52. you  want different settings, you will have to edit "LEDA:src/Make.src" and
  53. "LEDA:prog/Make.pro",  and  compile  again:   "cd  LEDA:src/amiga", "make".
  54. Before  trying to compile please have a look into the Makefile, to check if
  55. you have all the required utilitites, e.g.  sed.
  56.  
  57.  
  58. USAGE:
  59.  
  60.     Just  proceed  as stated in the LEDA docs, but replace all "-lWx -lX11"
  61. by  "-lWx".   This  may  be  the  case  for some Makefiles in the LEDA:prog
  62. subdirectories, e.g.  LEDA:prog/window/makefile.
  63.  
  64.  
  65. THE PREFERENCE FILE:
  66.  
  67.     The  prefs file has a very primitive design to keep the parsing simple.
  68. So  you  must not edit anything except the characters between the pipe sign
  69. ("|") and the end-of-line.
  70.  
  71. Screen Width              |1024
  72. Screen Height             |768
  73. Screen Depth [5,...,8]    |6
  74. Screen ModeID             |PICASSO:1024x768
  75. Screen Overscan [OSCAN_*] |1
  76. Screen AutoScroll         |0
  77. Text Font Name            |courier.font
  78. Text Font Size            |13
  79. Text Font Style           |0
  80. Bold Font Name            |courier.font
  81. Bold Font Size            |13
  82. Bold Font Style [FSF_*]   |1
  83. Message Font Name         |courier.font
  84. Message Font Size         |15
  85. Message Font Style        |0
  86. X11 Color Base            |usr:lib/X11/rgb.txt
  87. Picasso Workaround (0,1)  |1
  88.  
  89.     Note  that  LEDA  generally  requires a relatively high resolution, for
  90. example  the  default  window size is 700*700 Pixel.  The ModeID must match
  91. exactly,  use  the  "ScreenMode"  preference  program  for  reference.  The
  92. Overscan values can be one of:
  93.  
  94. #define OSCAN_TEXT    (1)    /* entirely visible    */
  95. #define OSCAN_STANDARD    (2)    /* just past edges    */
  96. #define OSCAN_MAX    (3)    /* as much as possible    */
  97. #define OSCAN_VIDEO    (4)    /* even more than is possible    */
  98.  
  99. The Font Style can be one of:
  100.  
  101. #define    FS_NORMAL    0    /* normal text (no style bits set) */
  102. #define    FSF_UNDERLINED    0x01
  103. #define    FSF_BOLD    0x02
  104. #define    FSF_ITALIC    0x04
  105.  
  106. The  X11  Color  Base  may  be put whereever you want, but I think that the
  107. specified directory is a standard location under Unix.
  108.  
  109.  
  110. FEATURES & LIMITATIONS:
  111.  
  112.     Most  functions  are  correctly emulated, including line dash patterns,
  113. X11 style color selection, window events, timing functions.  However, there
  114. are some X11 features that are not easily emulated:
  115.  
  116.  - Thick lines. I use a bunch of normal lines to imitate this, but it
  117.    may look ugly in exor-mode, or with a dash pattern.
  118.  - Dashed arcs. I use normal arcs instead
  119.  - Bitmap insertions. I didn't have the time to write PBM import routines.
  120.  - Iconification is not supported
  121.  
  122.     Since  many  LEDA programs make extensive use of all 3 mouse buttons, I
  123. have  mapped F1, F2, F3 to LMB, MMB, RMB, respectively, for the ones of you
  124. with only 2 button mice.
  125.  
  126.  
  127. DISCLAIMER & COPYRIGHT:
  128.  
  129.     Standard disclaimer applies:  Use entirely at your own risk.  Please do
  130. not redistribute modified parts of this archive.
  131.  
  132.  
  133. FUTURE:
  134.  
  135.     This  version  works  quite  fine for me.  I currently write my diploma
  136. thesis  on  my  Amiga,  and  compile  it on some SunOS SparcStations at the
  137. university without ANY changes or "#ifdef AMIGA"s at all (!)
  138.  
  139.     If  you  want  some  new functions implemented or have any suggestions,
  140. criticism, please write to:
  141.  
  142. Kay Drangmeister <kay@cip.informatik.uni-wuerzburg.de>
  143.                  <K.Drangmeister@insider.sub.de>
  144.  
  145.